GXGetJobError(IM:XP)

Inside Macintosh: QuickDraw GX Printing /

Chapter 2 - Core Printing Features / Core Printing Features Reference

GXGetJobError
You can use the GXGetJobError function to obtain the first error encountered for a particular job object since the last call to GXGetJobError.
OSErr GXGetJobError (gxJob aJob);
aJob
A reference to the job object whose most recent error you want to obtain.

function result
An error code of type OSErr.

DESCRIPTION
The GXGetJobError function returns printing-related errors associated with a job object. Initially, you can call this function to obtain the current error code. If you immediately call this function a second time, it returns noErr.
You can use the GXSetJobError function to store an error in a specific job object.

SPECIAL CONSIDERATIONS
After an error occurs, calls to QuickDraw GX printing-related functions associated with the specified job object return immediately without executing, until the GXGetJobError function is called.
The GXGetJobError function does not move Macintosh memory; however, your application should not call this function at interrupt time, because it relies on data structures that may move.

SEE ALSO
Error-handling methods using the GXGetJobError function are described in "Error Handling," which begins on page 2-14.
The GXSetJobError function is described in the next section.